package com.atguigu.cloud.config;

import io.swagger.v3.oas.models.ExternalDocumentation;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * @auther zzyy
 * @create 2023-12-22 14:50
 */
//名字随便起的都可以
@Configuration
public class Swagger3Config
{
    //微服务有很多，这里可以进模块划分，例：支付微服务模块、其它微服务模块、客户微服务模块等
    //表示   /pay/**  pay开头的都是支付微服务模块   /other/** 、/others  other开头的和others都是其它微服务模块  按照业务分门别类
    @Bean
    public GroupedOpenApi PayApi()
    {
        return GroupedOpenApi.builder().group("支付微服务模块").pathsToMatch("/pay/**").build();
    }
    @Bean
    public GroupedOpenApi OtherApi()
    {
        return GroupedOpenApi.builder().group("其它微服务模块").pathsToMatch("/other/**", "/others").build();
    }
    /*@Bean
    public GroupedOpenApi CustomerApi()
    {
        return GroupedOpenApi.builder().group("客户微服务模块").pathsToMatch("/customer/**", "/customers").build();
    }*/

    //文档的描述说明

    @Bean
    public OpenAPI docsOpenApi()
    {
        return new OpenAPI()
                //添加一些自己要留的信息
                //cloud2024工程  通用设计rest1.0
                .info(new Info().title("cloud2024")
                        .description("通用设计rest")
                        .version("v1.0"))
                //有什么问题可查询 https://yiyan.baidu.com/
                .externalDocs(new ExternalDocumentation()
                        .description("www.atguigu.com")
                        .url("https://yiyan.baidu.com/"));
    }
}

